home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / libelfutil / xlate_pro_add_info.z / xlate_pro_add_info
Text File  |  1998-10-30  |  8KB  |  132 lines
  1.  
  2.  
  3.  
  4. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____IIIINNNNFFFFOOOO((((3333EEEE))))                                  XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____IIIINNNNFFFFOOOO((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______iiii_nnnn_ffff_oooo - set recorded overall info
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_eeee_llll_ffff_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_mmmm_pppp_llll_rrrr_ssss_////_xxxx_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  17.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_XXXX_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  18.      _iiii_nnnn_tttt _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______aaaa_dddd_dddd______iiii_nnnn_ffff_oooo_((((_xxxx_llll_aaaa_tttt_eeee______tttt_aaaa_bbbb_llll_eeee______pppp_rrrr_oooo _pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  19.        _EEEE_llll_ffff_6666_4444______SSSS_xxxx_wwww_oooo_rrrr_dddd _dddd_aaaa_tttt_aaaa______mmmm_oooo_vvvv_eeee_dddd_,,,,
  20.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp______ffff_wwww_aaaa_,,,,
  21.        _EEEE_llll_ffff_6666_4444______AAAA_dddd_dddd_rrrr   _ssss_tttt_aaaa_rrrr_tttt_uuuu_pppp______llll_wwww_aaaa_,,,,
  22.        _EEEE_llll_ffff_3333_2222______WWWW_oooo_rrrr_dddd   _oooo_llll_dddd______tttt_eeee_xxxx_tttt______eeee_xxxx_iiii_ssss_tttt_ssss_,,,,
  23.        _EEEE_llll_ffff_3333_2222______WWWW_oooo_rrrr_dddd   _oooo_llll_dddd______tttt_eeee_xxxx_tttt______aaaa_llll_llll_oooo_cccc
  24.      _))))_;;;;
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      _x_l_a_t_e__p_r_o__a_d_d__i_n_f_o is used to set values into the xlate data stream.
  28.      _p_r_o__t_a_b_l_e__p_t_r must be a valid open producer translate table handle.
  29.  
  30.      These values cannot be calculated by the library but must be supplied by
  31.      the application.  If  _x_l_a_t_e__p_r_o__a_d_d__i_n_f_o is not called, 0 will be used as
  32.      a default value for the corresponding fields of the xlate header in the
  33.      created byte stream.
  34.  
  35.      _d_a_t_a__m_o_v_e_d
  36.              Pass in the number of bytes the data section was moved (normally
  37.              only pixie(1) moves data sections).  The value is not the amount
  38.              the text was moved but the amount that the data had moved above
  39.              and beyond text movement.  The movement is important because
  40.              _r_l_d(1) relies on the distance between text and data being fixed.
  41.              The movement is an important fact in the translation process but
  42.              the fact is not ordinarily needed by consuming tools or
  43.              applications.
  44.  
  45.      _s_t_a_r_t_u_p__f_w_a
  46.              Pass in the pc address (First Word Address) (in the translated
  47.              text) of special startup code introduced by a translation tool.
  48.              _p_i_x_i_e is currently the only tool creating such special startup
  49.              code.  Other tools should pass in 0 for a value.
  50.  
  51.      _s_t_a_r_t_u_p__l_w_a
  52.              Pass in the pc address (Last Word Address) (in the translated
  53.              text) of the end (actually one past the last address) of the
  54.              startup code introduced by a translation tool.  _p_i_x_i_e is
  55.              currently the only tool creating such special startup code.
  56.              Other tools should pass in 0 for a value.
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____IIIINNNNFFFFOOOO((((3333EEEE))))                                  XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____AAAADDDDDDDD____IIIINNNNFFFFOOOO((((3333EEEE))))
  70.  
  71.  
  72.  
  73.      _o_l_d__t_e_x_t__e_x_i_s_t_s
  74.              Pass in is 1 if the original (untranslated) text is present in
  75.              the executable or DSO.  Pass in 0 if the original text is not
  76.              present.  _c_o_r_d(1)ed DSOs often do not have the original text
  77.              present.  _p_i_x_i_ed applications and DSOs usually do have the
  78.              original text present.
  79.  
  80.      _o_l_d__t_e_x_t__a_l_l_o_c
  81.              Pass in 1 if the original text is present and is marked to be
  82.              brought into memory automatically on program startup.  Otherwise
  83.              _o_l_d__t_e_x_t__a_l_l_o_c pass in 0.  This lets a consuming application
  84.              (such as a debugger) know what it has to do to find the relevant
  85.              original text image.
  86.  
  87. FFFFIIIILLLLEEEESSSS
  88.      /usr/include/libXlate.h
  89.      /usr/include/cmplrs/xlate.h
  90.      /usr/include/elf.h
  91.      /usr/include/dwarf.h
  92.      /usr/include/libdwarf.h
  93.      /usr/lib/libelfutil.a
  94.  
  95. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  96.      Returns XLATE_TB_STATUS_NO_ERROR (0) on success.  In case of error, a
  97.      negative number is returned indicating the error.  In case of error,
  98.      nothing is returned thru the pointer arguments which would return values
  99.      on successful call (values might have been changed thru these pointers
  100.      but any such changes are not meaningful).
  101.  
  102.      Error returns possible are:
  103.  
  104.      _X_L_A_T_E__T_B__S_T_A_T_U_S__I_N_V_A_L_I_D__T_A_B_L_E
  105.              means that the _p_r_o__t_a_b_l_e__p_t_r is not a valid open producer handle.
  106.  
  107.      _X_L_A_T_E__T_B__S_T_A_T_U_S__A_D_D__T_O_O__L_A_T_E
  108.              means that the call has occurred after a call to
  109.              _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r which is not allowed. call
  110.              _x_l_a_t_e__p_r_o__a_d_d__i_n_f_o before calling _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      libelfutil(5), open(2), xlate(4), xlate_init_fd(3), xlate_finish(3),
  114.      xlate_get_info(3), xlate_pro_init(3), xlate_pro_finish(3)
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.